Array.slice()

Доступность

Flash Player 5.

Синтаксис

my_array.slice( [ start:Number [ , end:Number ] ] ) : Array

Параметры

start Число, определяющее индекс отправной точки для метода slice. Если start отрицательное число, отсчёт элементов начинается с конца массива, начиная с -1.

end Индекс элемента, перед которым заканчивается, подлежащий выделению, фрагмент. Если данный параметр опущен, метод slice выделяет все элементы от отправной точки до конца массива. Если end отрицательное число, ведётся обратный отсчёт с конца массива, где -1 - индекс последнего элемента массива.

Возвращает

Массив.

Описание

Метод; возвращает новый массив, извлекая из основного массива часть последовательности. Основной массив при этом остаётся без изменений. Возвращаемый массив, включает элемент start и все элементы до/но не включая/ элемента end .

Если Вы не передаёте методу никаких параметров, создаётся дубликат массива my_array .

Пример

В следующем примере создаётся массив с пятью домашними животными и , используя метод slice(),возвращается массив с животными о четырёх лапах :

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myFourLeggedPets_array:Array = new Array();
var myFourLeggedPets_array = myPets_array.slice(0, 2);
trace(myFourLeggedPets_array);  // возвращает cat,dog
trace(myPets_array);  // возвращает cat,dog,fish,canary,parrot

Пример создания массива с пятью животными; вызова метода slice() с отрицательным параметром start , для копирования двух последних элементов массива :

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myFlyingPets_array:Array = myPets_array.slice(-2);
trace(myFlyingPets_array); // выводится canary,parrot

Пример создания массива с пятью животными; вызова метода slice() с отрицательным параметром end , для копирования среднего элемента массива :

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myAquaticPets_array:Array = myPets_array.slice(2,-2);
trace(myAquaticPets_array); // возвращает fish

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление